Command: QH (Query Host). Can be used in online, offline or secure state.
Function: To display details of the Host port configuration of the HSM.
Inputs: None
Outputs: The
message header length. This is the number of characters at the front of each
command from the Host to the HSM (after the STX character). The HSM returns the
message header in the response.
The protocol used.
The character format (EBCDIC or ASCII).
In an asynchronous system, the response delay. This is the delay before the HSM
responds to the Host. It allows use of half-duplex Host communications that
require a defined delay between the transmission of a command and the response
from the HSM.
In an SNA - SDLC synchronous system, whether the interface is DCE or DTE.
In an SNA - SDLC synchronous system, the IBM environment. This can be IMS or
CICS. Message identifier and offset are shown.
In an SNA - SDLC synchronous system, the interface port type. This can be
RS-232 or V.35.
In an SNA - SDLC synchronous system, the SDLC station address.
In an asynchronous system, the Host baud rate.
In an asynchronous system, the Host word format.
In Ethernet use, the IP address. This is the Internet Protocol address of the
HSM in the system.
In Ethernet use, the Well-Known-Address. This is the publicised TCP Port
address of the HSM.
Errors: None.
Example 1 (for transparent asynchronous communications):
Online> QH <Return>
Message header length: 04
Protocol: Transparent Asynchronous
Character format: ASCII
Terminating Sequence: 03 00
Interface: DCE
Response delay (ms): 00
Baud: 9600
Word format: 7 bits, no parity, 1 stop
Example 2 (for SNA-SDLC communications):
Online> QH <Return>
Message header length: 08
Protocol: SNA/SDLC 3274
Character format: EBCDIC
Station Address: C1
Host environment: IMS
IMS message identifier: PIN,MAC
IMS identifier offset: 03
Interface: V.35, DCE
Baud: 64000
Word format: 8 bits, no parity
Example 3 (for Ethernet communication with UDP):
Online> QH <Return>
Message header length: 04
Protocol: Ethernet
Character format: ASCII
IP address: 128.100.003.001
Well-Known-Port address: 01500
Transport: UDP
Default gateway address: 128.100.003.005
Subnet mask: 255.255.255.000
Example 4 (for Ethernet communication with TCP/IP):
Online> QH <Return>
Message header length: 04
Protocol: Ethernet
Character format: ASCII
IP address: 128.100.003.001
Well-Known-Port address: 01500
Transport: TCP, 6 connections
TCP keep_alive value: 120
Default gateway address: 128.100.003.005
Subnet mask: 255.255.255.000
Example 5 (for Ethernet communication with UDP and TCP/IP):
Offline> QH <Return>
Message header length: 04
Protocol: Ethernet
Character format: ASCII
IP address: 128.100.003.001
Well-Known-Port address: 01500
Transport: UDP and TCP, 6 connections
TCP keep_alive value: 120
Default gateway address: 128.100.003.005
Subnet mask: 255.255.255.000
Example 6: (ESCON)
Offline> QH <Return>
Message header length: 04
Protocol: ESCON
Character format: ASCII